home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / preference programme / dtpref_inst / docs / dtpref.guide (.txt) next >
Amigaguide Document  |  1996-04-07  |  11KB  |  206 lines

  1. @database DTpref
  2. @$VER: DTpref.guide 2.2 (17.11.95)
  3. @(C) Swen K. Stullich/UFT
  4. @author Swen K. Stullich/UFT
  5. @WORDWRAP
  6. @index Index
  7. @node Main "DTpref 2.2"
  8. @prev Main
  9. @next Main
  10.                                   @{b}@{u}DTpref 2.2@{uu}@{ub}
  11.              @{b}DTpref@{ub} package is Copyright 
  12.  1995 @{"Swen K. Stullich/UFT" link Author}.
  13.                              All rights reserved.
  14.   The author's native language is german, so please forgive bad spelling, grammar mistakes etc. Or better - correct them.
  15.   @{" Copyright notice " link Copyright}
  16.   @{"   Introduction   " link Introduction}
  17.   @{"   Requirements   " link Requirements}
  18.   @{"   Installation   " link Installation}
  19.   @{"   Configuration  " link Configuration}
  20.   @{"      Thanks      " link Thanks}
  21.   @{"      History     " link History}
  22.   @{"       To do      " link ToDo}
  23. @endnode
  24. @node Copyright "DTpref Copyright"
  25. @prev Copyright
  26.  @{b}@{u}Copyright@{uu}@{ub}
  27.   @{b}DTpref@{ub} package is Copyright 
  28.  1995 @{"Swen K. Stullich/UFT" link Author}.
  29.   @{b}DTpref@{ub} is mailware. All rigths are reserved.
  30.    It is allowed to put this program
  31.  into AmiNet
  32.  on AmiNetCDs
  33.  on FredFishCDs
  34.  into BBS
  35.    all other distribution requires written permission from me.
  36.   @{b}DTpref@{ub} works fine, but I won`t give any guarantee: usage is your risk.
  37.   (I`m not liable for any results if you use @{b}DTpref@{ub}. It`s your problem. :-) )
  38.   This documentation is based on @{i}FontDT.guide@{ui}, which is Copyright 
  39.  1995 Michael Letowski.
  40.   List of all files in the distribution:
  41.    @{i}
  42.    DTpref.readme
  43.    DTpref.readme.info
  44.    Install
  45.    Install.info
  46.    Libs.info                        
  47.    Libs (dir)
  48.      gtlayout.library                 
  49.    Docs.info
  50.    Docs (dir)
  51.      DTpref.guide
  52.      DTpref.guide.info
  53.    DTpref.info
  54.    DTpref (dir)
  55.      DTpref
  56.      DTpref.info
  57. @{ui}
  58. @endnode
  59. @node Introduction "Introduction to DTpref"
  60.  @{b}@{u}Introduction@{uu}@{ub}
  61.   @{b}DTpref@{ub} is a preferences editor for @{"DataTypes" link DataTypes} with settable preferences.
  62.   The GUI has three signifcant areas:
  63.   @{b}Left side@{ub} is a listview-gadget, where you can select a @{"DataType" link DataTypes} for changing the preferences.
  64.   @{b}Right side@{ub} is the area to act on the datatype-preferences. All @{"DataTypes" link DataTypes} has common the @{i}IO-Gadgets@{ui} and the @{i}Information@{ui}-gadget. The other layout depends on the used @{"DataType" link DataTypes}.
  65.     @{i}IO-Gadgets@{ui} are:
  66.       @{b}Save@{ub} the preferences for this @{"DataType" link DataTypes} onto the disk.
  67.       @{b}Use@{ub} the preferences only. After a reset the old settings will be available and used.
  68.       @{b}Default@{ub} set the layout to the internal (@{"DataType" link DataTypes})settings.
  69.       @{b}Restore@{ub} the settings from "ENV:".
  70.       @{b}LSaved@{ub} loads the settings by the disk.
  71.     @{i}Information-gadget@{ui} gives some infos about the @{"DataType" link DataTypes} and his author.
  72.   @{b}The bottom@{ub} has the three gadgets:
  73.     @{i}Save@{ui} all @{"DataTypes" link DataTypes}-settings to disk, without checking, if they was changed.
  74.     @{i}Use@{ui} all @{"DataTypes" link DataTypes}-settings, withou checking, if they was changed.
  75.     @{i}Cancel@{ui} (or use the @{i}CloseWindow@{ui}) don't save or use the new @{"DataTypes" link DataTypes}-settings.
  76.     These gadgets also quits the programm.
  77.   The menu gives you the abillity to:
  78.  get information about the author and the programm: @{i}Project/Version/Copyright ...@{ui}
  79.  to quit the programm @{i}Project/Quit@{ui}. This is identical to the @{i}Cancel@{ui}-button
  80.  reset all @{"DataTypes" link DataTypes} to default @{i}Edit/Reset to Defaults@{ui}
  81.  load the last saved settings for all @{"DataTypes" link DataTypes} @{i}Edit/Last Saved@{ui}
  82.  or restore all the @{"DataTypes" link DataTypes}-settings @{i}Edit/Restore@{ui}
  83. @endnode
  84. @node Requirements "Requirements for DTpref"
  85.  @{b}@{u}Requirements@{uu}@{ub}
  86.   @{b}DTpref@{ub} requires AmigaDOS 3.0 or higher
  87.   For the GUI @{b}DTpref@{ub} requires the @{i}gtlayout.library@{ui} V23+, by @{b}Olaf 'Olsen' Barthel@{ub}.
  88. @endnode
  89. @node Installation "Installation of DTpref"
  90.  @{b}@{u}Installation@{uu}@{ub}
  91.   Use supplied @{i}Installer @{ui}script to copy necessary files.
  92. @endnode
  93. @node Configuration "Configuring operation of DTpref"
  94.  @{b}@{u}Configuration@{uu}@{ub}
  95.   You can configurate @{b}DTpref@{ub} with @{"ToolTypes" link ToolTypes}.
  96. @{fg highlight}DT@{fg text}
  97.   @{fg highlight}DT=@{fg text}@{i}DTname,Filename @{ui}
  98.   Where @{i}DTname @{ui}the name of the @{"DataType" link DataTypes} is, and @{i}Filename @{ui}the name of the file is, which will be used to load the @{"DataType" link DataTypes}.
  99.   The @{i}Filename @{ui}must be in the same directory, where @{b}DTpref@{ub} is, or the complete path must be given.
  100.   Before using this @{"ToolType" link ToolTypes} check out, if the @{"DataTypes" link DataTypes} supports this feature. At the moment only @{b}icon.datatype V39.4@{ub} supports this. Other @{"DataTypes" link DataTypes} may follow (like @{b}binary.datatype@{ub}).
  101. @{fg highlight}DEBUG@{fg text} (since V2.1)
  102.   @{fg highlight}DEBUG=@{fg text}@{i}TRUE|FALSE @{ui}
  103.   With this option you can enable the debugmode in @{b}DTpref@{ub}. This is usefull, if you have a @{"DataType" link DataTypes}, where you doesn't know, if it support @{b}DTpref@{ub} or not.
  104.   If you enable this option (@{fg highlight}DEBUG=TRUE@{fg text}) there will be some additional outputs, if there is an error while starting @{b}DTpref@{ub}.
  105.   Default: @{i}DEBUG=FALSE @{ui}
  106. @{fg highlight}TESTMODE@{fg text} (since V2.1)
  107.   @{fg highlight}TESTMODE=@{fg text}@{i}OFF|MIN|MAX @{ui}
  108.   This option is usefull for debuging @{"DataTypes" link DataTypes}. It's so only usefull for @{"DataType" link DataTypes}-programmers, so if you only use @{b}DTpref@{ub} as user, don't activate this option.
  109.   If you enable this option, you can get informations, which method is running, or if your @{"DataType" link DataTypes} calls @{i}SetHook @{ui}or @{i}Gethook @{ui}. With @{fg highlight}TESTMODE=MIN@{fg text} only the methods and hooks are displayed, while @{fg highlight}TESTMODE=MAX@{fg text} also the parameters shows.
  110.   Default: @{i}TESTMODE=OFF @{ui}
  111. @{fg highlight}TESTDT@{fg text} (since V2.1)
  112.   @{fg highlight}TESTDT=@{fg text}@{i}DTname @{ui}
  113.   If you enables @{fg highlight}TESTMODE@{fg text} you must specify the @{"DataType" link DataTypes}, which one should be traced.
  114.   Default: @{i}TESTDT="" @{ui}
  115. @{fg highlight}DISABLEDT@{fg text} (since V2.1)
  116.   @{fg highlight}DISABLEDT=@{fg text}@{i}binary|exe|font|hwgpost|jfif|photocd @{ui}
  117.   Here you can disable the internal @{b}DTpref@{ub}-preferences for the specified @{"DataType" link DataTypes}. For example, if you get a new @{b}binary.datatype@{ub}, which supports @{b}DTpref@{ub}, you can use @{fg highlight}DISABLEDT=binary@{fg text} to disable the internal binary-gui.
  118.   Default: @{i}DISABLEDT="" @{ui}
  119. @endnode
  120. @node Thanks "DTpref Thanks"
  121.  @{b}@{u}Thanks@{uu}@{ub}
  122.   Thanks must go to:
  123.    @{b}Olaf 'Olsen' Barthel@{ub} for his great gui-library @{i}gtlayout.library@{ui}. Without this library this tool wouldn't exists!!!
  124.    @{b}Stefan Ruppert@{ub} for the support of @{b}DTpref@{ub}
  125.    all the others, which send me an e-mail after releasing V1.0. Without you there wouldn't probably no V2.0 of @{b}DTpref@{ub}
  126. @endnode
  127. @node History "DTpref History"
  128.  @{b}@{u}History@{uu}@{ub}
  129.   Version 1.0 (22.06.95) - initial release.
  130.   Version 2.0 (27.09.95) - complete rewritten.
  131.    Improvements:
  132.  GUI changed. Now you can save, load, ... the config of each datatype individually
  133.  Now @{"DataTypes" link DataTypes} can use @{b}DTpref@{ub} with some new methods, so programmers of @{"DataTypes" link DataTypes} could support DTpref
  134.   Version 2.1 (21.10.95)
  135.  Check if already running
  136.  New option @{"DEBUG" link Configuration} to enable debug-mode
  137.  New option @{"TESTMODE and TESTDT" link Configuration} for DTpref support programmers
  138.  New Option @{"DISABLEDT" link Configuration} to disable the internal preferences
  139.  New MagicWB-Icon for @{b}DTpref@{ub}. Thanks to @{i}Hans Seiler @{ui}for this artwork.
  140.  @{b}DTpref@{ub} checks now, if started by shell.
  141.   Version 2.2 (13.11.95)
  142.  @{b}DTpref@{ub} has now the possibility to view the @{"DataType" link DataTypes}-Object, if the @{"DataType" link DataTypes} support this. For this feature you must activate the @{b}View Object@{ub}-Gadget above the @{b}Information@{ub}-Gadget.
  143.  Memoryusage improved
  144. @endnode
  145. @node ToDo "To do in DTpref"
  146. @next ToDo
  147.  @{b}@{u}To do@{uu}@{ub}
  148.  Support more @{"DataTypes" link DataTypes}
  149.  Support locale
  150.  If you are missing a feature in @{b}DTpref@{ub} feel free to write it to @{"me" link Author}
  151. @endnode
  152. @node DataTypes "DataTypes Information"
  153. @prev DataTypes
  154. @next DataTypes
  155.  @{b}@{u}DataTypes@{uu}@{ub}
  156.   @{i}DataTypes @{ui}is an AmigaDOS subsystem (introduced in AmigaDOS 3.0) for dealing with different types of files found on different machines (PC's, Macs and Amigas). @{i}DataTypes @{ui}can be used for recognizing types of files and interpreting informations in this files. An example of the latter is @{i}MultiView@{ui}, which can show many types of data.
  157.   @{i}DataTypes @{ui}divide all files into the following main categories:
  158.  @{i}syst @{ui}(System) - system files;
  159.  @{i}text @{ui}(Text) - textual files;
  160.  @{i}docu @{ui}(Document) - documents (spreadsheet data, text with pictures etc.);
  161.  @{i}soun @{ui}(Sound) - sound samples;
  162.  @{i}inst @{ui}(Instrument) - musical instruments;
  163.  @{i}musi @{ui}(Music) - songs;
  164.  @{i}pict @{ui}(Picture) - graphics;
  165.  @{i}anim @{ui}(Animation) - animations;
  166.  @{i}movi @{ui}(Movie) - animation with sound.
  167.    Each category is further divided into subclasses. Each subclass interprets one type of file, converting it to some universal format.
  168. @endnode
  169. @node ToolTypes "ToolTyes"
  170. @prev ToolTypes
  171. @next ToolTypes
  172.  @{b}@{u}ToolTypes@{uu}@{ub}
  173. @endnode
  174. @node Author "About the Author"
  175. @prev Author
  176. @next Author
  177.  @{b}@{u}About the Author@{uu}@{ub}
  178.   @{b}DTpref@{ub} package was written by @{b}Swen K. Stullich/UFT@{ub}
  179.   If you have something to say me (questions, remarks, suggestions, wishes, bug reports) please contact me (I like receiving mail!):
  180.   by E-Mail (preferred way):
  181.    @{b}Swen@Trashcan.mcnet.de@{ub}
  182.   by normal mail:
  183.    @{b}Swen K. Stullich
  184.    Am Sch
  185. lkegraben 14a
  186.    38826 Salzgitter
  187.    Germany@{ub}
  188. @endnode
  189. @node Index "DTpref Index"
  190. @prev Index
  191. @next Index
  192.   @{b}@{u}Index@{uu}@{ub}
  193.   @{"     Author     " link Author}
  194.   @{"  Configuration " link Configuration}
  195.   @{"Copyright notice" link Copyright}
  196.   @{"    DataTypes   " link DataTypes}
  197.   @{"    ToolTypes   " link ToolTypes}
  198.   @{"      Fonts     " link Fonts}
  199.   @{"     History    " link History}
  200.   @{"  Installation  " link Installation}
  201.   @{"  Introduction  " link Introduction}
  202.   @{"     Thanks     " link Thanks}
  203.   @{"  Requirements  " link Requirements}
  204.   @{"      To do     " link ToDo}
  205. @endnode
  206.